table of contents
XmCreateSelectionBox(library call) | XmCreateSelectionBox(library call) |
NAME¶
XmCreateSelectionBox — The SelectionBox widget creation function
SYNOPSIS¶
#include <Xm/SelectioB.h> Widget XmCreateSelectionBox( Widget parent, String name, ArgList arglist, Cardinal argcount);
DESCRIPTION¶
XmCreateSelectionBox creates an unmanaged SelectionBox. A SelectionBox is used to get a selection from a list of alternatives from the user and includes the following:
- •
- A scrolling list of alternatives
- •
- An editable text field for the selected alternative
- •
- Labels for the list and text field
- •
- Three or four buttons
The default button labels are OK, Cancel, and Help. By default, an Apply button is also created. If the parent of the SelectionBox is a DialogShell, it is managed; otherwise it is unmanaged. Additional work area children may be added to the SelectionBox after creation.
- parent
- Specifies the parent widget ID
- name
- Specifies the name of the created widget
- arglist
- Specifies the argument list
- argcount
- Specifies the number of attribute/value pairs in the argument list (arglist)
For a complete definition of SelectionBox and its associated resources, see XmSelectionBox(3).
RETURN¶
Returns the SelectionBox widget ID.